home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Util / D-De / DeskCheck / DeskCheck.Txt < prev    next >
Encoding:
Text File  |  1987-03-15  |  4.6 KB  |  126 lines  |  [TEXT/EDIT]
  1. ---
  2.  
  3. This draft written February 4, 1987.
  4. E.Vishniac / P.O. Box 1357 / East Arlington, MA 02174
  5.  
  6. Following are the alerts from DeskCheck, listed by ALRT number with a short
  7. explanation of each one's significance.  ^0, ^1, ^2, and ^3 indicate text which
  8. is supplied at run-time.
  9.  
  10.  
  11. 128: "Welcome to DeskCheck!"
  12.  
  13. This alert is normal.
  14.  
  15. 129: "All done."
  16.  
  17. This alert is normal.
  18.  
  19. 130: "SetVol Failed!  Error code = ^0."
  20.  
  21. DeskCheck was unable to move to some directory in the course of its search.
  22. This should never happen.
  23.  
  24. 131: "OpenResFile failed!  Error code = ^0."
  25.  
  26. DeskCheck attempts to check every file that has a resource fork.  Some files
  27. have bogus resource forks, which cause errors when an attempt is made to open
  28. them as resource files.  In extreme cases, the Mac may bomb in OpenResFile.
  29.  
  30. 132: "This file has one or more BNDLs, but the bundle bit is not set.
  31.       Number of BNDL resources = ^0."
  32.  
  33. In the case of the Desktop file, this is normal.  For any other file, it
  34. warns that the Finder won't take any notice of the file's bundle because
  35. the bundle bit is off.
  36.  
  37. 133: "BNDL ^0 has ^1 resource types instead of the expected 2."
  38.  
  39. BNDL resources normally have two lists of resources: one for ICN# resources
  40. and one for FREF resources.  A different number of lists is unusual, but not
  41. necessarily an error.
  42.  
  43. 134: "The signature resource listed in BNDL ^0, ^1 ^2, is missing."
  44.  
  45. An application's "signature" is the unique identifier which connects it with
  46. the documents it creates or uses.  The signature resource is a resource whose
  47. resource type is the same as the creator of files associated with the
  48. application.  The signature is listed in the application's bundle.
  49.  
  50. 135: "BNDL ^0 refers to resource type '^1'.  The usual types are 'FREF' and
  51.       'ICN#'."
  52.  
  53. Types other than ICN# and FREF in the bundle are unusual, but not necessarily
  54. an error.
  55.  
  56. 136: "BNDL ^0 is too short!"
  57.  
  58. DeskCheck parses each bundle to be sure that the actual resource length is
  59. long enough to contain the bundle's required fields and lists.  A bundle
  60. resource that's too short is a severe error.
  61.  
  62. 137: "BNDL ^0 is longer than expected."
  63.  
  64. DeskCheck parses each bundle to be sure that the actual resource length is
  65. no longer than required to contain the bundle's required fields and lists.
  66. A bundle that's too long is unusual, but not necessarily a problem.
  67.  
  68. 138: "ICN# ^2 is ^3 bytes instead of the usual 256."
  69.  
  70. ICN# resources have a fixed format, with a length of exactly 256 bytes.
  71. A different length is a minor error.
  72.  
  73. 139: "FREF ^2 is only ^3 bytes, which is less than the minimum FREF size of six."
  74.  
  75. An FREF consists of a required signature (four bytes) and ICN# local ID (two
  76. bytes), optionally followed by a string (zero to 256 bytes).  So, an FREF
  77. could reasonably be any size from six to 256 bytes.  An FREF of less than
  78. six bytes is a severe error.
  79.  
  80. 140: "FREF ^2 is ^3 bytes long, which exceeds the maximum FREF size of 262."
  81.  
  82. An FREF which runs past the maximum length of 262 bytes is unusual, but not
  83. necessarily a problem.
  84.  
  85. 141: "BNDL ^0 refers to resource ^1 ^2, which is missing."
  86.  
  87. DeskCheck verifies that all resources listed in the bundle are actually present
  88. in the same file.  A missing resource is a severe error.
  89.  
  90. 142: "Check contents of volume "^0"?"
  91.  
  92. This inquiry is normal.
  93.  
  94. 143: "BNDL ^0 does not contain the usual list of ICN# resources."
  95.  
  96. This is not necessarily a problem, but means the bundle isn't much good.
  97.  
  98. 144: "BNDL ^0 does not contain the usual list of FREF resources."
  99.  
  100. This is not necessarily a problem, but means the bundle isn't much good.
  101.  
  102. 145: "BNDL ^0 refers to FREF ^1, whose icon local ID is ^2.
  103.       This local ID is unresolved.  That is, it is not the local ID of any 
  104.       member of the ICN# resource list in the same bundle."
  105.  
  106. Each FREF associates a file type with an ICN# resource.  The ICN# is identified
  107. by a local ID, which is mapped to the ICN#'s real ID through the ICN# list in
  108. the bundle itself.  An unresolved local ID is a severe error.
  109.  
  110. 146: "This file's bundle doesn't assign an icon to this file.
  111.       There's no FREF with a file type that matches this file's type, which
  112.       is '^0'."
  113.  
  114. In the case of the Desktop file, this alert is normal.  For any other file, it
  115. suggests that the bundle isn't complete.  This is not necessarily a problem, but
  116. means that the file will appear with a default icon on the desktop.
  117.  
  118. 147: "This file's bundle doesn't appear to be for this file.
  119.       The OwnerName in the bundle doesn't match the file's creator, which is
  120.       '^0'."
  121.  
  122. In the case of the Desktop file, this alert is normal.  For any other file, it
  123. warns that the file's bundle doesn't match information about the file itself.
  124.  
  125. ---
  126.